Инструкция по IDEF0 \ DOCTOR

Инсталляция системы IDEF0 \ Doctor

• Общие сведения

  Поскольку система IDEF0 \ Doctor разработана в среде Microsoft® Visual Studio® .Net, она не будет работать на Вашем компьютере, если на нем предварительно не установлена среда .Net Framework . IDEF0 \ Doctor - это одно из приложений среды Net Framework. Для экономии Вашего времени в данной инструкции не будем объяснять зачем понадобилась среда .Net Framework компании Microsoft. Достаточно поверить, что завести на своем компьютере .Net Framework не только "круто", престижно, гигиенично, практично, но и очень полезно. Неверующим прошу обращаться непосредственно к Биллу Гейтсу.

  Коротко лишь скажу о том, что любая программа, подготовленная в среде MS Studio .Net (и IDEF0 \ Doctor является такой программой), не содержит в себе исполняемого модуля программы, а состоит из так называемых "сборок" (assembles) с метаданными. Что это такое, не важно, а важно то, что при запуске IDEF0 \ Doctor среда .Net Framework выполняет большой объем работы, включая создание исполняемого модуля и его запуск.

  Поэтому инсталляционный диск IDEF0 \ Doctor содержит :

  • инсталляционную программу Dotnetfx.exe для .Net Framework, свободно распространяемую компанией Microsoft, и

  • файлы "сборок" для IDEF0 \ Doctor.

  Всем, кто не собирается модифицировать программный код системы IDEF0 \ Doctor для своих специфических целей, рекомендую пропустить текст, изложенный ниже и сразу перейти к разделу "Инсталляция".

• К сведению разработчиков элементов IDEF0 \ Doctor

  Среда .NET Framework предоставляет разработчику программ один неограниченно распространяемый инсталлятор, содержащий общие исполняемые языковые и .NET Framework компоненты, необходимые для исполнения приложений  .NET Framework. Распространяемая среда  .NET Framework доступна в виде отдельного исполняемого файла Dotnetfx.exe (Вы можете загрузить Dotnetfx.exe с Центра загрузки или сайта обновлений Microsoft).

  Среда .NET Framework требует наличия лицензионного соглашения, которое дает Вам специфические права по распространению Dotnetfx.exe. Если Вы ранее инсталлировали Microsoft .NET Framework SDK, Microsoft® Visual Studio® .NET или загрузили Dotnetfx.exe через Web, на Вашем компьютере уже имеется копия лицензионного соглашения для Dotnetfx.exe (см. условия лицензионного соглашения).

  Вы можете вручную запустить инсталляцию Dotnetfx.exe на компьютере, или этот файл может быть запущен в составе программы, инсталлирующей одно из приложений .NET Framework. При этом у Вас должны быть привилегии администратора, чтобы инсталлировать Dotnetfx.exe (см. более подробную информацию об инсталляции Dotnetfx.exe и требования к конфигурации программного и аппаратного обеспечения). Если Вы ранее инсталлировали .NET Framework SDK или Microsoft Visual Studio .NET, Вам нет необходимости инсталлировать Dotnetfx.exe.

  При установке приложений, созданных с помощью Visual Studio .NET, .NET Framework должен быть уже установлен на компьютере. .NET Framework не должен включаться в пакет установки Windows Installer, создаваемый с помощью инструментария Visual Studio .NET, а должен устанавливаться отдельно.

  Существуют три возможных способа установки приложений .NET Framework:

  • Предложите пользователю вручную инсталлировать исполняемый модуль .NET Framework.

  • Используйте Setup.exe из примера Bootstrapper для инсталляции .NET Framework (Dotnetfx.exe) и затем запустите пакет Windows Installer для Вашего приложения.

  • Администратор сети может распространить Dotnetfx.exe , используя электронные средства распространения программного обеспечения (см. более подробные инструкции). 

  Предупреждение.   Устанавливаемый проект приложения, связанный с .NET Framework, автоматически добавляет совмещенный модуль (dotnetfxredist_x86_xxx.msm, где xxx является кодом языка) в папку с вычисляемым адресом. Этот совмещенный модуль не может распространяться, а хранится для внутреннего использования проектом в целях предотвращения учета индивидуальных .NET "сборок". По умолчанию он исключается из списка, а попытки включить его в список будут приводить к ошибке.

• Ручная инсталляция .NET Framework

  Многократно распространяемый пакет .NET Framework в виде независимого исполняемого файла Dotnetfx.exe  используется для инсталляции .NET Framework. Пакет доступен из нескольких источников. Тем не менее, Вы не можете быть уверенным, что пользователи Вашего приложения знают, как извлечь и инсталлировать его. По этой причине Вам следует модифицировать устанавливаемый проект так, чтобы пользователь был снабжен инструкциями.

  Инсталляторы, созданные с использованием инструментария Visual Studio .NET включают условие по умолчанию (MsiNetAssemblySupport) для проверки наличия .NET Framework на компьютере. Если эта среда не будет найдена, инсталляция будет прекращена и диалоговое окно выдаст следующее сообщение: "Эта установка требует наличия .NET Framework. Пожалуйста установите .NET Framework и запустите установку снова." Вам следует заменить это сообщение другим сообщением по Вашим потребностям.

  Например, если Ваше приложение распространяется с помощью CD-ROM,  сообщение может быть следующим: "Это приложение требует наличия .NET Framework. Пожалуйста инсталлируйте .NET Framework запустив файл  Dotnetfx.exe, который размещен в папке NetInstall инсталляционного диска, и затем снова запустите инсталляцию."

  Чтобы изменить сообщение о состоянии установки программы следует:

  1. Выбрать в Solution Explorer размещаемый проект.

  2. Активируйте меню "View -> Editor -> Launch Conditions".

  3. В редакторе "Launch Conditions Editor" выберете узел "MsiNetAssemblySupport".

  4. В окне "Properties" выбирете поле "Message" и замените текст, размещенный в этом поле, собственным текстом.

     Note   The default message is automatically translated for localized versions of the installer. If you customize the text, you will need to translate it yourself for any localized versions.

  The .NET Framework requires that MDAC 2.6 or later be installed for any application that includes data access. Like the .NET Framework, MDAC cannot be installed as a part of a deployment project. Microsoft provides MDAC_typ.exe, a stand-alone executable file that can be run to install MDAC. The MDAC redistributable is available from the Universal Data Access Web site, however you should not assume that your application's users know where to get it or how to install it. For this reason, you should modify your deployment project to provide instructions to the user. You can download a sample executable file that encapsulates the MDAC installation with a Windows Installer (MSI) package from Install DCOM and MDAC Through a Windows Installer Package on the Microsoft Product Support Services Web site.

  If your application includes data access, you should also add a launch condition to check for MDAC 2.6 or later.

  To add a launch condition for MDAC

  1. Select the deployment project in Solution Explorer. From the View menu, point to Editor and choose Launch Conditions.

  2. Select the Requirements on Target Machine node. From the Action menu, choose Add Registry Launch Condition.

  3. Select the Search for RegistryEntry1 node. In the Properties window, select the RegKey property and type Software\Microsoft\DataAccess.

  4. Select the Root property and select vsdrrHKLM.

  5. Select the Value property and type FullInstallVer.

  6. Select the Property property and type MDACSEARCH.

  7. In the Launch Conditions Editor, select the Condition1 node. In the Properties window, select the Condition property and select MDACSEARCH>="2.6".

  8. Select the Message property and type MDAC version 2.6 or later must be installed prior to installing this application. MDAC is available for download from the Universal Data Access Web site.

     Note   You can modify the message text for your particular situation. For example, you could point to a network share where MDAC is located.

  Installing the .NET Framework with the Setup.exe Bootstrapper Sample

  The Setup.exe Bootstrapper sample is an application that installs the .NET Framework redistributable package and then launches a Windows Installer package (.msi file) for a .NET Framework application. An editable settings file, settings.ini, specifies the locations of the redistributable package and your installer.

  For your convenience, you can download a precompiled version of the Setup.exe Bootstrapper sample. It is freely redistributable.

  When using the Setup.exe Bootstrapper sample with an installer created using Visual Studio .NET deployment tools, you first need to modify the deployment project. A deployment project includes a Windows Installer bootstrapper by default. You can remove this default installer because the .NET Framework redistributable also includes a Windows Installer bootstrapper.

  For .NET Framework applications that include data access, you can extend the Setup.exe Bootstrapper sample to silently install the MDAC redistributable, MDAC_typ.exe. You will need to add code that checks for the registry key HKLM\SOFTWARE\Microsoft\DataAccess where the value of FullInstallVer is 2.6 or later. You can download a sample executable file that encapsulates the MDAC installation with a Microsoft Installer (MSI) package from Install DCOM and MDAC Through a Windows Installer Package.

  To modify a deployment project for use with the Setup.exe Bootstrapper sample

  1. In Solution Explorer, select the deployment project.

  2. On the Project menu, click Properties.

  3. In the Property Pages dialog box, select the Bootstrapper property and set it to None.

  The next step is to build the deployment project and copy the resulting .msi file to a deployment location—for example, a directory on a CD-ROM or a network share. The Setup.exe Bootstrapper sample and the settings file also need to be copied to a deployment location, and the settings file must be modified to reflect the deployment locations.

  To edit the settings file to reflect deployment locations

  1. Open the file settings.ini in a text editor such as Notepad.

  2. Find the Msi=mySetup.msi entry and replace the default path with the path to your .msi file. For example, if mySetup.msi is located on the local computer in the same folder as Setup.exe, the path will be Msi=mySetup.msi. If mySetup.msi is located on a network share in a folder named myProjectFolder, an example of the path is Msi=\\myNetworkShare\myProjectFolder\mySetup.msi. If mySetup.msi is located in a folder named myInstallerFiles, on the same CD as Setup.exe, an example path is Msi=myInstallerFiles/mySetup.msi.

  3. Find the FxInstallerPath=c: entry and replace the default path with the correct path to the .NET Framework redistributable package, Dotnetfx.exe. For example, if Dotnetfx.exe is located on the local computer in a folder named myProjectFolder, the path will be FxInstallerPath=c:\myProjectFolder\. If Dotnetfx.exe is located on a network share in a folder named myProjectFolder, an example of the path might be FxInstallerPath=\\myNetworkShare\myProjectFolder\. If Dotnetfx.exe is located in a folder named myExecutables, on the same CD as Setup.exe, an example path is FxInstallerPath=myExecutables/.

  4. Save the settings.ini file.

  The Setup.exe Bootstrapper sample performs a comparison between the build number of the .NET Framework installed on the target computer and the build number of the .NET Framework being hosted by the application to install. If there is not a matching build number, Setup.exe installs the version of the .NET Framework being hosted by the application. If you want Setup.exe to check for a build number and language version of the .NET Framework, you must specify the language to check for in the settings.ini file. If you do not specify a language for the LanguageDirectory variable, Setup.exe checks for the English language version by default.

  The following table lists the available language versions and the culture name to specify in the settings.ini file.

  Language	Culture name
  Chinese (Simplified)	CHS
  Chinese (Traditional)	CHT
  French	fr
  German	de
  Italian	it
  Japanese	ja
  Korean	ko
  Spanish	es

  To edit the settings file to check for a language version

  1. Open the file settings.ini in a text editor such as Notepad.

  2. Find the 'LanguageDirectory= entry. Uncomment the entry and specify the correct language version to check for. For example, if you want Setup.exe to check for the French language version of the .NET Framework, specify LanguageDirectory=fr.

  3. Save the settings.ini file.

   

•  

• Инсталляция

.